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APPENDIX A 

namespace System.Storag 

{ 

abstract class ItemContext : IDisposabl , IS rvic Provid r 

{ 

ItemContext Creation and Management Members 

// Applications cannot create ItemContext objects directly nor can they derive 
// classes from ItemContext. 
interal ltemContext(); 

// Create ItemContext that can be used to search the specified paths or, if no path 

// is specified, the default store on the local computer. 

public static ItemContext Open(); 

public static ItemContext Open( string path ); 

public static ItemContext Open( params stringQ paths ); 

// Return the paths specified when the ItemContext was created, 
public stringQ GetOpenPaths(); 

// Create a copy of this ItemContext. The copy will have independent transaction, caching 

// and update state. The cache will initially be empty. It is expected that using a 

// cloned ItemContext would be more efficient then opening a new ItemContext using the 

// same item domain(s). 

public ItemContext Clone(); 

// Close the ItemContext. Any attempt to use the ItemContext after it is closed will 

// result in an ObjectDisposedException. 

public void Close(); 

void IDisposable.Dispose(); 

// True if any domain specified when the ItemConext was opened resolved to a remote 
// computer. 

public bool IsRemote { get; } 

II Returns an object that can provide the requested service type. Returns null if the 
// requested service cannot be provided. The use of the IServiceProvider pattern allows 
// API that are not normally used and could confuse developers to be factored out of 
// the ItemContext class. ItemContext can provide the following kinds of services: 
// lltemSerialization, IStoreObjectCache 
public object GetService( Type serviceType ); 

Update Related Members 

// Saves changes represented by all modified objects and all objects passed to 
// MarkForCreate or MarkForDelete. May throw UpdateCollisionException if an update 
// collision is detected, 
public void UpdateQ; 

// Saves changes represented by the specified objects. The objects must have either 
// been modified or passed to MarkForCreate or MarkForDelete, otherwise Argument- 
// Exception is thrown. May throw UpdateCollisionException if an update collision is 
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//detected. 

public void Update( obj ct obj ctTollpdat ); 
public void Updatej (Enumerable objectsToUpdate ); 

// Refreshes the content of the specified objects from the store. If the object has 

// been modified, the changes are overwritten and the object is no longer considered 

// modified. Throws ArgumentException if anything other then an item, item extension, 

// or relationship object is specified. 

public void Refresh( object objectToRefresh ); 

public void Refresh( Enumerable objectsToRefresh ); 

// Raised when an update detects that data has been changed in the store between when a 
// modified object was retrieved and an attempt was made to save it. If no event handler 
// is registered, the update throws an exception. If an event handler is registered, it 
// can throw an exception to abort the update, case the modified object to overwrite 
// the data in the store or merge the changes made in the store and in the object, 
public event ChangeCollisionEventHandler UpdateCollision; 

// Raised at various points during update processing to provide update progress 
// information. 

public event UpdateProgressEventhandler UpdateProgress; 

// Async versions of Update 

public lAsyncResult BeginUpdate( lAsyncCallback callback, object state ); 
public lAsyncResult BeginUpdatej object objectToUpdate, 

lAsyncCallback callback, 

object state ); 

public lAsyncResult BeginUpdate( (Enumerable objectsToUpdate, 

lAsyncCallback callback, 

object state ); 
public void EndUpdate( lAsyncResult result ); 

// Async versions of Refresh 

public lAsyncResult BeginRefresh( object objectToRefresh, 
lAsyncCallback callback, 
object state ); 

public lAsyncResult BeginRefresh( Enumerable objectsToRefresh, 

lAsyncCallback callback, 

object state ); 
public void EndRefresh( lAsyncResult result ); 

Transaction Related Members 

// Begins a transaction with the specified isolation level. The default isolation level 
// is ReadCommited. In all cases, a distributed transaction is started because it may 
// have to encompass changes stream typed item properties, 
public Transaction BeginTransaction(); 

pubiic Transaction BeginTransaction( System.Data.lsolationLevel isolationLevel ); 
Search Related Members 

// Create an ItemSearcher that will search this item context for objects of the 
// specified type. Throws ArgumentException if a type othern then an item, 
// relationship, or item extension is specified. 
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public ItemSearcher GetSearcher( Type typ ); 

// Find an item given its id. 

public It m FindltemByld( Itemld itemld ); 

// Find an item given its path. The path may be absolute or relative. If it is relative, 
// NotSupportedException will be thrown if multiple item domains were specified when 
//the ItemContext was opened. Will return null if no such item exists. Creates a 
// connection to the \\machine\share part of the domain to retrieve the item. The 
// item will be assocaited with that domain, 
public Item FindltemByPath( string path ); 

// Find an item given its path. The path is relative to the specified item domain. 
// Creates a connection to the specified domain to retrieve the item. The item will be 
// associated with that domain. Will return null if no such item exists, 
public Item FindltemByPath( string domain, string path ); 

// Find a set of items given a path. The path is relative to the item domains specified 
// when the ItemContext was opened. Will return an empty result if no such item exists, 
public FindResult FindAllitemsByPath( string path ); 

// Find a relationship given its ids. 

public Relatioinship FindRelationshipByld( Itemld itemID, 
Relationships relationship^ ); 

// Find a item extension given its ids. 

public ItemExtension FindltemExtensionByld( Itemld itemld, 
ItemExtensionld itemExtensionld ); 

// Find all item, relationship, or item extensions of the specified type optionally 
// satisifing a given filter. Throws ArgumentException if a type other then one of 
// these is specified. 

public FindResult FindAII( Type type ); 

public FindResult FindAII( Type type, string filter ); 

// Find any item, relationship, or item extensions of the specified type that satisfies 
// a given filter. Throws ArgumentException if a type other then one of these is 
// specified. Returns null if no such object is found, 
public object FindOne( Type type, string filter ); 

// Find the item, relationship, or item extensions of the specified type that satisfies 
// a given filter. Throws ArgumentException if a type other then one of these is 
// specified. Throws ObjectNotFoundException if no such object was found. Throws 
// MultipleObjectsFoundException if more then one object was found, 
public object FindOnly( Type type, string filter ); 

// Returns true if an item, relationship, or item extensions of the specified type that 
// satisfies a given fiiter exists. Throws ArgumentException if a type other then one 
// of these is specified. 

public bool Exists( Type type, string filter ); 

// Specifies how the objects returned by a search relate to the object identity map 
// maintained by the ItemContext. 
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public SearchCollisionMode SearchCollisionM d { g t; set; } 

// Raised when PreserveModifiedObjects is specified for ResultMapping. This event allows 
// the application to selectivly update the modified object with data retrieved with the 
// search. 

public event ChangeCollisionEventHandler SearchCollision; 

// Incorporate an object from annother ItemContext into this item context. If an object 
// representing the same item, relationship or item extension does not already exist 
// this this ItemContext's identity map, a clone of the object is created and added to 
// the map. If an object does exist, it is updated with the state and content of the 
// specified object in a way concistant with the SearchCollisionMode. 
public Item lncorporateltem( Item item ); 

public Relationship lncorporateRelationship( Relationship relationship ); 
public ItemExtension lncorporateltemExtension( ItemExtension itemExtension ); 



// Handler for ItemContext.UpdateCollision and ItemSearcher.SearchCollision events, 
public delegate void ChangeCollisionEventHandler( object source, 
ChangeCollisionEventArgs args ); 

// Arguments for the ChangeCollisionEventHandler delegate, 
public class ChangeCollisionEventArgs : EventArgs 

{ 

// Modified item, item extension, or relationship object, 
public object ModifiedObject { get; } 

// Properties from store. 

public IDictionary StoredProperties { get; } 

} 

// Handler for ItemContext.UpdateProgress. 

public delegate void UpdateProgressEventHandler( ItemContext itemContext, 
UpdateProgressEventArgs args ); 

// Arguments for the UpdateProgressEventHandler delegate 
public class ChangeCollisionEventArgs : EventArgs 

{ 

//The current update operation. 

public UpdateOperation CurrentOperation { get; } 

// The object that is currently being updated, 
public object CurrentObject { get; } 

} 

// Specifies how the objects returned by a search relate to the objects identity map 
// maintained by the itemContext. 
public enum SearchCollisionMode 

{ 

// Indicates that new objects should be created and returned. Objects representing the 
// same item, item extension, or relationship in the identity map are ignored. If this 
// option is specified the SearchCollision event will not be raised. 
DoNotMapSearchResults, 
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// Indicates that objects from the identity map should be returned. It the content of 
// an object has been modified by the application, the modified object's content is 
// preserved. If the object has not been modified, its content is updated with the 
// data returned by the search. The Application may provide an handler for the 
// SearchCollision event and selectivly update the object as desired. 
PreserveModifiedObjects, 

// Indicates that the objects from the identity map should be returned. The content 
// of the object is updated with the data returned by the search, even if the object 
// has been modified by the application. If this option is specified the Search- 
// Collision event will not be raised. 
OverwriteModifiedObjects 

} 

// The current update operation, 
public enum UpdateOperation 

{ 

// Provided when Update is first called. CurrentObject will be null. 
OverallUpdateStarting, 

// Provided just before Update returns after a successful update. CurrentObject will be 
//null. 

OverattUpdateCompletedSucessfully, 

// Provided just before Update throws an exception. CurrentObject will be the exception 
// object. 

OverallUpdateCompletedUnsuccessfully, 

// Provided when the update of an object is started. CurrentObject will reference the 

// object that will be used for the updated. 

ObjectUpdateStaring, 

// Provided when a new connection is needed. CurrentObject will be a string that contains 
// the path identifying an item domain as passed to ItemContext.Open or retrieved from 
// the Location field of a relationship. 
OpeningConnection 

} 

} 
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APPENDIX B 

namespace Syst m.Storage 

{ 

// Executes a search across a specific type in an item context, 
public class ItemSearcher 

{ 

Constructors 
public ltemSearcher(); 

public ltemSearcher( Type targetType, ItemContext context ); 
public ltemSearcher( Type targetType, ItemContext context, 
params SearchExpressionf] filters ); 

Properties 

// The filters used to identify matching objects, 
public SearchExpressionCollection Filters {get;} 

// The ItemContext that specifies the domains that will be searched, 
public ItemContext ItemContext {get; set;} 

// The search parameter collection. 

public ParameterCollection Parameters {get;} 

// The type the searcher will operate against. For simple searches this is the type of 
// the object that will be returned, 
public Type TargetType {get; set;} 

Search Methods 

// Find objects of TargetType that satisfiy the conditions specified by Filters. Returns 
// an empty FindResult if no such objects exist, 
public FindResult FindAIIQ; 

public FindResult FindAII( FindOptions findOptions ); 
public FindResult FindAII( params SortOptionf] sortOptions ); 

// Find any one object of TargetType that satisifies the conditions specified by Filters. 
// Returns null if no such object exists, 
public object FindOne(); 

public object FindOne( FindOptions findOptions ); 
public object FindOne( params SortOptionfl sortOptions ); 

II Find the object of TargetType that satisfies the conditions specified by Filters. 

// Throws ObjectNotFoundException if no such object was found. Throws MultipleObjects- 

// Found Exception if more then one object was found. 

public object FindOnly(); 

public object FindOnlyj FindOptions findOptions ); 

// Determine if an object of TargetType that satisfies the conditions specified by 
// Filters exists, 
public b olExists(); 
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// Creates an object that can be used to more efficiently execute the same search 
// repeatedly. 

public PreparedFind Prepar Find(); 

public Pr paredFind PrepareFind( FindOptions findOptions ); 
public PreparedFind PrepareFindj params SortOption[] sortOptions ); 

// Retrieves the number of records that would be returned by FindAII(). 
public int GetCount(); 

// Asynchronous versions of various methods, 
public lAsyncResult BeginFindAII( AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindAII( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindAII( SortOption[] sortOptions, 
AsyncCallback callback, 
object state ); 

public FindResult EndFindAII( lAsyncResult ar ); 

public lAsyncResult BeginFindOne( AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOne( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOne( SortOptionQ sortOptions, 
AsyncCallback callback, 
object state ); 

public object EndFindOne( lAsyncResult asyncResult ); 

public lAsyncResult BeginFindOnly( AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOnly( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOnly( SortOptionf] sortOptions, 
AsyncCallback callback, 
object state ); 

public object EndFindOnly( lAsyncResult asyncResult ); 

public lAsyncResult BeginGetCount( AsyncCallback callback, 
object state ); 

public int EndGetCount( lAsyncResult asyncResult ); 
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public I AsyncResult B ginExists( AsyncCallback callback, 
object stat ); 

public bool EndExists( lAsyncR suit asyncResult ); 

// Options used when executing a search, 
public class FindOptions 

{ 

public FindOptionsQ; 

public FindOptions( params SortOptionQ sortOptions ); 

// Specifies if delay loadable fields should be delay loaded, 
public bool DelayLoad {get; set;} 

// The number of matches that are returned, 
public int MaxResults {get; set;} 

// A collection of sort options. 

public SortOptionCollection SortOptions {get;} 



// Represents a parameter name and value, 
public class Parameter 

{ 

// Initializes a Parameter object with a name and value, 
public Parameter( string name, object value ); 

// The parameter's name, 
public string Name {get;} 

// The parameter's value, 
public object Value {get; set;} 



// A collection of parameter name/value pairs, 
public class ParameterCollection : ICollection 

{ 

public ParameterCollection(); 

public int Count {get;} 

pubiic object this[string name] {get; set.;} 

public object SyncRoot {get;} 

public void Add( Parameter parameter ); 

public Parameter Add( string name, object value ); 
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public bo I Contains( Param ter parameter ); 
public boot Contains( string nam ); 

public void CopyTo( ParameterQ array, int index ); 
void IC Hection.CopyTo( Array array, int index ); 

Enumerator lEnumerable.GetEnumeratorO; 

public void Remove( Parameter parameter ); 
public void Remove( string name ); 



// Represents a search that has been optimized for repeated execution, 
public class PreparedFind 

{ 

public ItemContext ItemContext {get;} 
public ParameterCollection Parameters {get;} 
public FindResult FindAIIQ; 
public object FindOne(); 
public object FindOnly(); 
public bool Exists(); 



// Specifies sorting options used in a search, 
public class SortOption 

{ 

// Initialize a object with default values, 
public SortOptionQ; 

// Initializes a SortOptions object with SearchExpression, order. 

public SortOption( SearchExpression SearchExpression, SortOrder order ); 

// A search SearchExpression that identifies the property that will be sorted, 
public SearchExpression Expression {get; set;} 

// Specifies ascending or descending sort order, 
public SortOrder Order {get; set;} 

} 

// A collection of sort option objects, 
public class SortOptionCollection : IList 

{ 

public SortOptionCoii ctionQ; 
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public SortOption this[int index] {get; set;} 
public int Add( S rtOption value ); 

public int Add( S arch Expression expression, SortOrd r order ); 
int IList.Add( object value ); 

public void Clear(); 

public bool Contains( SortOption value ); 
bool IList.Contains( object value ); 

public void CopyTo( SortOption[] array, int index ); 
void ICollection.CopyTo( Array array, int index ); 

public int Count {get;} 

(Enumerator (Enumerable.GetEnumerator(); 

public void lnsert( int index, SortOption value ); 
void IList.lnsert( int index, object value ); 

public int lndexOf( SortOption value ); 
int IList.lndexOf( object value ); 

public void Remove( SortOption value ); 
void IList.Remove( object value ); 
public void RemoveAt( int index ); 

public object SyncRoot {get;} 



// Specifies the sort order using in a SortOption object, 
public enum SortOrder 

{ 

Ascending, 
Descending 

} 

} 
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APPENDIX C 

namespace System.St rage 

{ 

public abstract class FindResult : lAsyncObjectReader 

{ 

public FindResultQ; 

// Moves the FindResult to the next position in the result, 
public boot Read(); 

public lAsyncResult BeginRead( AsyncCallback callback, object state ); 
public bool EndRead( lAsyncResult asyncResult ); 

// The current object, 
public object Current {get;} 

// Returns whether or not the FindResult contains any objects, 
public bool HasResults {get;} 

// Returns whether or not the FindResult is closed, 
public bool IsClosed {get;} 

// Returns the type of items in this FindResult. 
public Type ObjectType {get;} 

// Closes the FindResult 

public void Close(); 

void IDisposable.Dispose(); 

// Returns an enumerator over the FindResult, starting at the current position. Advancing 
// any enumerator on the FindResult advances all enumerators as well as the FindResult 
// itself. 

Enumerator IEnumerable.GetEnumerator(); 
public FindResultEnumerator GetEnumerator(); 



public abstract class FindResultEnumerator : I Enumerator, Disposable 

{ 

public abstract object Current { get; } 
public abstract bool MoveNext(); 
public abstract void ResetQ; 
public abstract void CloseQ; 

void iOisposabie.Dispose(); 



namespace System 
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// A common interface for iterating over objects. 

public interface lObjectRead r : (Enumerable, Disposable 

{ 

object Current {get;} 
bool IsClosed {get;} 
bool HasResults {get;} 
Type ObjectType {get;} 

bool Read(); 
void Close(); 

} 

// Adds asynchronous methods to lObjectReader 
public interface lAsyncObjectReader : lObjectReader 

{ 

lAsyncResult BeginRead( AsyncCallback callback, object state ); 
bool EndRead( lAsyncResult result ); 

} 

} 
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